home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Linux / Kubuntu 8.10 / kubuntu-8.10-desktop-i386.iso / casper / filesystem.squashfs / usr / lib / python2.5 / site.pyc (.txt) < prev    next >
Python Compiled Bytecode  |  2008-10-29  |  14KB  |  479 lines

  1. # Source Generated with Decompyle++
  2. # File: in.pyc (Python 2.5)
  3.  
  4. """Append module search paths for third-party packages to sys.path.
  5.  
  6. ****************************************************************
  7. * This module is automatically imported during initialization. *
  8. ****************************************************************
  9.  
  10. In earlier versions of Python (up to 1.5a3), scripts or modules that
  11. needed to use site-specific modules would place ``import site''
  12. somewhere near the top of their code.  Because of the automatic
  13. import, this is no longer necessary (but code that does it still
  14. works).
  15.  
  16. This will append site-specific paths to the module search path.  On
  17. Unix (including Mac OSX), it starts with sys.prefix and
  18. sys.exec_prefix (if different) and appends
  19. lib/python<version>/site-packages as well as lib/site-python.
  20. On other platforms (such as Windows), it tries each of the
  21. prefixes directly, as well as with lib/site-packages appended.  The
  22. resulting directories, if they exist, are appended to sys.path, and
  23. also inspected for path configuration files.
  24.  
  25. FOR DEBIAN, this sys.path is augmented with directories in /usr/local.
  26. Local addons go into /usr/local/lib/python<version>/site-packages
  27. (resp. /usr/local/lib/site-python), Debian addons install into
  28. /usr/lib/python<version>/site-packages.
  29.  
  30. A path configuration file is a file whose name has the form
  31. <package>.pth; its contents are additional directories (one per line)
  32. to be added to sys.path.  Non-existing directories (or
  33. non-directories) are never added to sys.path; no directory is added to
  34. sys.path more than once.  Blank lines and lines beginning with
  35. '#' are skipped. Lines starting with 'import' are executed.
  36.  
  37. For example, suppose sys.prefix and sys.exec_prefix are set to
  38. /usr/local and there is a directory /usr/local/lib/python2.5/site-packages
  39. with three subdirectories, foo, bar and spam, and two path
  40. configuration files, foo.pth and bar.pth.  Assume foo.pth contains the
  41. following:
  42.  
  43.   # foo package configuration
  44.   foo
  45.   bar
  46.   bletch
  47.  
  48. and bar.pth contains:
  49.  
  50.   # bar package configuration
  51.   bar
  52.  
  53. Then the following directories are added to sys.path, in this order:
  54.  
  55.   /usr/local/lib/python2.5/site-packages/bar
  56.   /usr/local/lib/python2.5/site-packages/foo
  57.  
  58. Note that bletch is omitted because it doesn't exist; bar precedes foo
  59. because bar.pth comes alphabetically before foo.pth; and spam is
  60. omitted because it is not mentioned in either path configuration file.
  61.  
  62. After these path manipulations, an attempt is made to import a module
  63. named sitecustomize, which can perform arbitrary additional
  64. site-specific customizations.  If this import fails with an
  65. ImportError exception, it is silently ignored.
  66.  
  67. """
  68. import sys
  69. import os
  70. import __builtin__
  71.  
  72. def makepath(*paths):
  73.     dir = os.path.abspath(os.path.join(*paths))
  74.     return (dir, os.path.normcase(dir))
  75.  
  76.  
  77. def abs__file__():
  78.     """Set all module' __file__ attribute to an absolute path"""
  79.     for m in sys.modules.values():
  80.         if hasattr(m, '__loader__'):
  81.             continue
  82.         
  83.         
  84.         try:
  85.             m.__file__ = os.path.abspath(m.__file__)
  86.         continue
  87.         except AttributeError:
  88.             continue
  89.             continue
  90.         
  91.  
  92.     
  93.  
  94.  
  95. def removeduppaths():
  96.     ''' Remove duplicate entries from sys.path along with making them
  97.     absolute'''
  98.     L = []
  99.     known_paths = set()
  100.     for dir in sys.path:
  101.         (dir, dircase) = makepath(dir)
  102.         if dircase not in known_paths:
  103.             L.append(dir)
  104.             known_paths.add(dircase)
  105.             continue
  106.     
  107.     sys.path[:] = L
  108.     return known_paths
  109.  
  110.  
  111. def _init_pathinfo():
  112.     '''Return a set containing all existing directory entries from sys.path'''
  113.     d = set()
  114.     for dir in sys.path:
  115.         
  116.         try:
  117.             if os.path.isdir(dir):
  118.                 (dir, dircase) = makepath(dir)
  119.                 d.add(dircase)
  120.         continue
  121.         except TypeError:
  122.             continue
  123.             continue
  124.         
  125.  
  126.     
  127.     return d
  128.  
  129.  
  130. def addpackage(sitedir, name, known_paths):
  131.     """Add a new path to known_paths by combining sitedir and 'name' or execute
  132.     sitedir if it starts with 'import'"""
  133.     if known_paths is None:
  134.         _init_pathinfo()
  135.         reset = 1
  136.     else:
  137.         reset = 0
  138.     fullname = os.path.join(sitedir, name)
  139.     
  140.     try:
  141.         f = open(fullname, 'rU')
  142.     except IOError:
  143.         return None
  144.  
  145.     
  146.     try:
  147.         for line in f:
  148.             if line.startswith('#'):
  149.                 continue
  150.             
  151.             if line.startswith('import'):
  152.                 exec line
  153.                 continue
  154.             
  155.             line = line.rstrip()
  156.             (dir, dircase) = makepath(sitedir, line)
  157.             if dircase not in known_paths and os.path.exists(dir):
  158.                 sys.path.append(dir)
  159.                 known_paths.add(dircase)
  160.                 continue
  161.     finally:
  162.         f.close()
  163.  
  164.     if reset:
  165.         known_paths = None
  166.     
  167.     return known_paths
  168.  
  169.  
  170. def addsitedir(sitedir, known_paths = None):
  171.     """Add 'sitedir' argument to sys.path if missing and handle .pth files in
  172.     'sitedir'"""
  173.     if known_paths is None:
  174.         known_paths = _init_pathinfo()
  175.         reset = 1
  176.     else:
  177.         reset = 0
  178.     (sitedir, sitedircase) = makepath(sitedir)
  179.     if sitedircase not in known_paths:
  180.         sys.path.append(sitedir)
  181.     
  182.     
  183.     try:
  184.         names = os.listdir(sitedir)
  185.     except os.error:
  186.         return None
  187.  
  188.     names.sort()
  189.     for name in names:
  190.         if name.endswith(os.extsep + 'pth'):
  191.             addpackage(sitedir, name, known_paths)
  192.             continue
  193.     
  194.     if reset:
  195.         known_paths = None
  196.     
  197.     return known_paths
  198.  
  199.  
  200. def addsitepackages(known_paths):
  201.     '''Add site-packages (and possibly site-python) to sys.path'''
  202.     prefixes = [
  203.         sys.prefix]
  204.     if sys.exec_prefix != sys.prefix:
  205.         prefixes.append(sys.exec_prefix)
  206.     
  207.     prefixes.insert(0, '/usr/local')
  208.     for prefix in prefixes:
  209.         if prefix:
  210.             if sys.platform in ('os2emx', 'riscos'):
  211.                 sitedirs = [
  212.                     os.path.join(prefix, 'Lib', 'site-packages')]
  213.             elif os.sep == '/':
  214.                 sitedirs = [
  215.                     os.path.join(prefix, 'lib', 'python' + sys.version[:3], 'site-packages'),
  216.                     os.path.join(prefix, 'lib', 'site-python')]
  217.             else:
  218.                 sitedirs = [
  219.                     prefix,
  220.                     os.path.join(prefix, 'lib', 'site-packages')]
  221.             if sys.platform == 'darwin':
  222.                 if 'Python.framework' in prefix:
  223.                     home = os.environ.get('HOME')
  224.                     if home:
  225.                         sitedirs.append(os.path.join(home, 'Library', 'Python', sys.version[:3], 'site-packages'))
  226.                     
  227.                 
  228.             
  229.             for sitedir in sitedirs:
  230.                 if os.path.isdir(sitedir):
  231.                     addsitedir(sitedir, known_paths)
  232.                     continue
  233.             
  234.     
  235.  
  236.  
  237. def setBEGINLIBPATH():
  238.     '''The OS/2 EMX port has optional extension modules that do double duty
  239.     as DLLs (and must use the .DLL file extension) for other extensions.
  240.     The library search path needs to be amended so these will be found
  241.     during module import.  Use BEGINLIBPATH so that these are at the start
  242.     of the library search path.
  243.  
  244.     '''
  245.     dllpath = os.path.join(sys.prefix, 'Lib', 'lib-dynload')
  246.     libpath = os.environ['BEGINLIBPATH'].split(';')
  247.     if libpath[-1]:
  248.         libpath.append(dllpath)
  249.     else:
  250.         libpath[-1] = dllpath
  251.     os.environ['BEGINLIBPATH'] = ';'.join(libpath)
  252.  
  253.  
  254. def setquit():
  255.     """Define new built-ins 'quit' and 'exit'.
  256.     These are simply strings that display a hint on how to exit.
  257.  
  258.     """
  259.     if os.sep == ':':
  260.         eof = 'Cmd-Q'
  261.     elif os.sep == '\\':
  262.         eof = 'Ctrl-Z plus Return'
  263.     else:
  264.         eof = 'Ctrl-D (i.e. EOF)'
  265.     
  266.     class Quitter((object,)):
  267.         
  268.         def __init__(self, name):
  269.             self.name = name
  270.  
  271.         
  272.         def __repr__(self):
  273.             return 'Use %s() or %s to exit' % (self.name, eof)
  274.  
  275.         
  276.         def __call__(self, code = None):
  277.             
  278.             try:
  279.                 sys.stdin.close()
  280.             except:
  281.                 pass
  282.  
  283.             raise SystemExit(code)
  284.  
  285.  
  286.     __builtin__.quit = Quitter('quit')
  287.     __builtin__.exit = Quitter('exit')
  288.  
  289.  
  290. class _Printer(object):
  291.     '''interactive prompt objects for printing the license text, a list of
  292.     contributors and the copyright notice.'''
  293.     MAXLINES = 23
  294.     
  295.     def __init__(self, name, data, files = (), dirs = ()):
  296.         self._Printer__name = name
  297.         self._Printer__data = data
  298.         self._Printer__files = files
  299.         self._Printer__dirs = dirs
  300.         self._Printer__lines = None
  301.  
  302.     
  303.     def _Printer__setup(self):
  304.         if self._Printer__lines:
  305.             return None
  306.         
  307.         data = None
  308.         for dir in self._Printer__dirs:
  309.             for filename in self._Printer__files:
  310.                 filename = os.path.join(dir, filename)
  311.                 
  312.                 try:
  313.                     fp = file(filename, 'rU')
  314.                     data = fp.read()
  315.                     fp.close()
  316.                 continue
  317.                 except IOError:
  318.                     continue
  319.                 
  320.  
  321.             
  322.             if data:
  323.                 break
  324.                 continue
  325.             None<EXCEPTION MATCH>IOError
  326.         
  327.         if not data:
  328.             data = self._Printer__data
  329.         
  330.         self._Printer__lines = data.split('\n')
  331.         self._Printer__linecnt = len(self._Printer__lines)
  332.  
  333.     
  334.     def __repr__(self):
  335.         self._Printer__setup()
  336.         if len(self._Printer__lines) <= self.MAXLINES:
  337.             return '\n'.join(self._Printer__lines)
  338.         else:
  339.             return 'Type %s() to see the full %s text' % (self._Printer__name,) * 2
  340.  
  341.     
  342.     def __call__(self):
  343.         self._Printer__setup()
  344.         prompt = 'Hit Return for more, or q (and Return) to quit: '
  345.         lineno = 0
  346.         while None:
  347.             
  348.             try:
  349.                 for i in range(lineno, lineno + self.MAXLINES):
  350.                     print self._Printer__lines[i]
  351.             except IndexError:
  352.                 break
  353.                 continue
  354.  
  355.             lineno += self.MAXLINES
  356.             key = None
  357.             while key is None:
  358.                 key = raw_input(prompt)
  359.                 if key not in ('', 'q'):
  360.                     key = None
  361.                     continue
  362.             if key == 'q':
  363.                 break
  364.                 continue
  365.             continue
  366.             return None
  367.  
  368.  
  369.  
  370. def setcopyright():
  371.     """Set 'copyright' and 'credits' in __builtin__"""
  372.     __builtin__.copyright = _Printer('copyright', sys.copyright)
  373.     if sys.platform[:4] == 'java':
  374.         __builtin__.credits = _Printer('credits', 'Jython is maintained by the Jython developers (www.jython.org).')
  375.     else:
  376.         __builtin__.credits = _Printer('credits', '    Thanks to CWI, CNRI, BeOpen.com, Zope Corporation and a cast of thousands\n    for supporting Python development.  See www.python.org for more information.')
  377.     here = os.path.dirname(os.__file__)
  378.     __builtin__.license = _Printer('license', 'See http://www.python.org/%.3s/license.html' % sys.version, [
  379.         'LICENSE.txt',
  380.         'LICENSE'], [
  381.         os.path.join(here, os.pardir),
  382.         here,
  383.         os.curdir])
  384.  
  385.  
  386. class _Helper(object):
  387.     """Define the built-in 'help'.
  388.     This is a wrapper around pydoc.help (with a twist).
  389.  
  390.     """
  391.     
  392.     def __repr__(self):
  393.         return 'Type help() for interactive help, or help(object) for help about object.'
  394.  
  395.     
  396.     def __call__(self, *args, **kwds):
  397.         import pydoc as pydoc
  398.         return pydoc.help(*args, **kwds)
  399.  
  400.  
  401.  
  402. def sethelper():
  403.     __builtin__.help = _Helper()
  404.  
  405.  
  406. def aliasmbcs():
  407.     '''On Windows, some default encodings are not provided by Python,
  408.     while they are always available as "mbcs" in each locale. Make
  409.     them usable by aliasing to "mbcs" in such a case.'''
  410.     if sys.platform == 'win32':
  411.         import locale as locale
  412.         import codecs as codecs
  413.         enc = locale.getdefaultlocale()[1]
  414.         if enc.startswith('cp'):
  415.             
  416.             try:
  417.                 codecs.lookup(enc)
  418.             except LookupError:
  419.                 import encodings as encodings
  420.                 encodings._cache[enc] = encodings._unknown
  421.                 encodings.aliases.aliases[enc] = 'mbcs'
  422.             except:
  423.                 None<EXCEPTION MATCH>LookupError
  424.             
  425.  
  426.         None<EXCEPTION MATCH>LookupError
  427.     
  428.  
  429.  
  430. def setencoding():
  431.     """Set the string encoding used by the Unicode implementation.  The
  432.     default is 'ascii', but if you're willing to experiment, you can
  433.     change this."""
  434.     encoding = 'ascii'
  435.     if encoding != 'ascii':
  436.         sys.setdefaultencoding(encoding)
  437.     
  438.  
  439.  
  440. def execsitecustomize():
  441.     '''Run custom site specific code, if available.'''
  442.     
  443.     try:
  444.         import sitecustomize as sitecustomize
  445.     except ImportError:
  446.         pass
  447.  
  448.  
  449.  
  450. def main():
  451.     abs__file__()
  452.     paths_in_sys = removeduppaths()
  453.     paths_in_sys = addsitepackages(paths_in_sys)
  454.     if sys.platform == 'os2emx':
  455.         setBEGINLIBPATH()
  456.     
  457.     setquit()
  458.     setcopyright()
  459.     sethelper()
  460.     aliasmbcs()
  461.     setencoding()
  462.     execsitecustomize()
  463.     if hasattr(sys, 'setdefaultencoding'):
  464.         del sys.setdefaultencoding
  465.     
  466.  
  467. main()
  468.  
  469. def _test():
  470.     print 'sys.path = ['
  471.     for dir in sys.path:
  472.         print '    %r,' % (dir,)
  473.     
  474.     print ']'
  475.  
  476. if __name__ == '__main__':
  477.     _test()
  478.  
  479.